Paid API一覧

※idPass版にのみ対応しています。json版には対応しておりません。

HTTP仕様(.idPass)

Request header
Content-Type: application/x-www-form-urlencoded;charset=windows-31j
Method
POST
Response header
Content-Type: text/plain;charset=windows-31j
Status Code
200:常に200を返却

SavePaidBuyer 取引先登録

指定された取引先情報をPaidに登録します。登録後、Paidにおいて審査が行われます。Paidから取引先にメールや電話で連絡をする場合があります。
審査が完了するとPaidで取引ができるようになります。取引先がすでにPaid会員であっても、加盟店様(Paidアカウント)ごとに審査が必要となります。
※審査には通常1~3営業日掛かります。

加盟店様サイトの会員新規登録時に登録するか、加盟店様サイトの既存会員情報を元にPaidの取引先登録をする想定です。
加盟店様サイトの会員登録時は、Paidの取引先登録必須項目をご準備ください。
※取引登録時には以下のページ内のPaid利用規約をご案内ください。
https://paid.jp/

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

PaidBuyerID 必須 半角英数記号20桁
Paid取引先ID
CompanyName 必須 全半角50バイト
会社名

個人事業主の場合は屋号・店舗等をご入力ください。

CompanyNameKana 必須 全半角カナ50バイト
会社名カナ

RepresentativeSei 必須 全半角50バイト
代表者姓

RepresentativeMei 必須 全半角50バイト
代表者名

RepresentativeSeiKana 必須 全半角カナ50バイト
代表者姓カナ

RepresentativeMeiKana 必須 全半角カナ50バイト
代表社名カナ

ZipCode 必須 半角数字記号8桁
郵便番号

999-9999形式

Prefecture 必須 全半角5バイト
都道府県

Address1 必須 全半角50バイト
市区町村

Address2 必須 全半角50バイト
町名・番地

Address3 全半角50バイト
ビル・マンション名

AuxName 全半角50バイト
部署名 / 支店名

ClerkSei 必須 全半角50バイト
担当者姓

ClerkMei 必須 全半角50バイト
担当者名

ClerkSeiKana 必須 全半角カナ50バイト
担当者姓カナ

ClerkMeiKana 必須 全半角カナ50バイト
担当者名カナ

Tel 必須 半角数字記号25桁
電話番号

市外局番からハイフンを入れて入力

Fax 半角数字記号25桁
FAX番号

市外局番からハイフンを入れて入力

MobileTel 半角数字記号25桁
携帯電話番号

999-9999-9999形式

Email 必須 半角英数記号100桁
メールアドレス

ClosingDay 半角数字2桁
締め日

20:20日締め
31:末日締め
※デフォルト値は31

PaymentMethod 半角数字1桁 固定
支払方法

1:銀行振り込み
2:口座振替
3:コンビニ払い
※デフォルト値は1
※コンビニ払いでご請求額が30万円を超えた場合は銀行振り込みとなります。

URL
/payment/SavePaidBuyer.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&PaidBuyerID=123456789&CompanyName=会社名&CompanyNameKana=カナ&RepresentativeSei=代表者性&RepresentativeMei=代表者名&RepresentativeSeiKana=カナ&RepresentativeMeiKana=カナ&ZipCode=123-4567&Prefecture=東京都&Address1=渋谷区&Address2=道玄坂&ClerkSei=担当者姓&ClerkMei=担当者名&ClerkSeiKana=カナ&ClerkMeiKana=カナ&Tel=12-3456-7890&Email=sample@sample.co.jp
レスポンス
正常
PaidBuyerID 半角英数記号20桁
Paid取引先ID

PaidID 半角英数10桁
Paid番号

Paidに登録した取引先企業に対して割り振られる番号です。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
PaidBuyerID=123456789&PaidID=123456789
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

CheckPaidBuyer 取引先ステータス確認

取引先の審査状態を確認します。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

PaidBuyerID 必須 半角英数記号20桁
Paid取引先ID

URL
/payment/CheckPaidBuyer.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&PaidBuyerID=123456789
レスポンス
正常
PaidBuyerID 半角英数記号20桁
Paid取引先ID
BuyerStatus 半角数字1桁 固定
審査状態

1:審査中
2:利用可能-取引中
3:利用可能-取引不可
4:利用不可
※「2」の場合、取引可能です。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
PaidBuyerID=123456789&BuyerStatus=2
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

CheckPaidRestAmount 取引先利用可能額確認

取引先の利用可能額を確認します。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

PaidBuyerID 必須 半角英数記号20桁
Paid取引先ID

URL
/payment/CheckPaidRestAmount.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&PaidBuyerID=123456789
レスポンス
正常
PaidBuyerID 半角英数記号20桁
Paid取引先ID

RestAmount
利用可能額

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
PaidBuyerID=123456789&RestAmount=100000
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

EntryTranPaid 取引登録

これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

OrderID 必須 半角英数記号27桁
オーダーID

Amount 必須 半角数字10桁
利用金額

利用金額を設定します。
※利用金額と税送料の合計が10桁

Tax 半角数字10桁
税送料

URL
/payment/EntryTranPaid.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&Amount=100
レスポンス
正常
AccessID 半角英数32桁 固定
取引ID

AccessPass 半角英数32桁 固定
取引パスワード

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

ExecTranPaid 決済実行

指定した決済内容でPaidに限度額の確認を行い、結果を返します。
処理完了後にPaidに受注登録しますので、ご利用状況によりご注文がキャンセル(決済失敗)される場合があります。
※決済結果は結果通知、または管理画面で確認することができます。
※Paidでは受注登録の翌日を起算日として180日経過すると、取引が自動キャンセルされます。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

AccessID 必須 半角英数32桁 固定
取引ID

AccessPass 必須 半角英数32桁 固定
取引パスワード

OrderID 必須 半角英数記号27桁
オーダーID

PaidBuyerID 必須 半角英数記号20桁
Paid取引先ID
Contents 全半角80バイト
注文内容

Paidの「注文内容」を設定します。
未指定の場合、Paidに登録される「注文内容」はオーダーIDが自動で設定されます。
※桁数はPaidの仕様に合わせて文字数となります。

ClientField1 全半角100バイト
加盟店自由項目1

ClientField2 全半角100バイト
加盟店自由項目2

ClientField3 全半角100バイト
加盟店自由項目3

ClientFieldFlag 半角数字1桁 固定
加盟店自由項目返却フラグ

以下のいずれかを設定します。
0:返却しない(デフォルト)
1:返却する

URL
/payment/ExecTranPaid.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&PaidBuyerID=123456789
レスポンス
正常
OrderID 半角英数記号27桁
オーダーID

Status
現状態

処理成功時は以下のステータスが返却されます。
・REQSUCCESS:要求成功

処理失敗時は処理前のステータスが返却されます。

ClientField1 全半角100バイト
加盟店自由項目1

ClientField2 全半角100バイト
加盟店自由項目2

ClientField3 全半角100バイト
加盟店自由項目3

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
OrderID=ORDER0000001&Status=REQSUCCESS&ClientField1=加盟店自由項目1&ClientField2=加盟店自由項目2&ClientField3=加盟店自由項目3
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

PaidChange 金額変更

仮売上の取引に対して金額の変更を行います。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

AccessID 必須 半角英数32桁 固定
取引ID

AccessPass 必須 半角英数32桁 固定
取引パスワード

OrderID 必須 半角英数記号27桁
オーダーID

Amount 必須 半角数字10桁
利用金額

変更後の利用金額を設定します。
※利用金額と税送料の合計が10桁

Tax 半角数字10桁
税送料

URL
/payment/PaidChange.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&Amount=100
レスポンス
正常
OrderID 半角英数記号27桁
オーダーID

Status
現状態

処理成功時は以下のステータスが返却されます。
・AUTH:仮売上

処理失敗時は処理前の下記ステータスが維持されます。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
OrderID=ORDER0000001&Status=AUTH
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

PaidCancel キャンセル

仮売上の取引に対して決済内容のキャンセルを行います。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

AccessID 必須 半角英数32桁 固定
取引ID

AccessPass 必須 半角英数32桁 固定
取引パスワード

OrderID 必須 半角英数記号27桁
オーダーID

URL
/payment/PaidCancel.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001
レスポンス
正常
OrderID 半角英数記号27桁
オーダーID

Status
現状態

処理成功時は以下のステータスが返却されます。
・CANCEL:キャンセル

処理失敗時は処理前のステータスが返却されます。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
OrderID=ORDER0000001&Status=CANCEL
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

PaidSales 実売上

仮売上の取引に対して実売上を行います。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

AccessID 必須 半角英数32桁 固定
取引ID

AccessPass 必須 半角英数32桁 固定
取引パスワード

OrderID 必須 半角英数記号27桁
オーダーID

FixedAt 半角数字8桁
決済確定日

(本パラメータを利用するには設定が必要なため弊社にご連絡ください。)
決済確定日に過去日を指定し実売上を行うことが可能です。

当日の日付が21日~第2営業日(※1)の場合:21日~当日の範囲で指定可能。
当日の日付が第3営業日(※2)~20日の場合:第3営業日(※2)~当日の範囲で指定可能。
※1 1月と5月は第1営業日。(ただし5月は1日、2日が平日の場合、第2営業日。)
※2 1月と5月は第2営業日。(ただし5月は1日、2日が平日の場合、第3営業日。)

例)
2020/8/4時点で指定できる日付:2020/7/21~2020/8/4
2020/8/13時点で指定できる日付:2020/8/5~2020/8/13
2020/8/25時点で指定できる日付:2020/8/21~2020/8/25

URL
/payment/PaidSales.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001
レスポンス
正常
OrderID 半角英数記号27桁
オーダーID

Status
現状態

処理成功時は以下のステータスが返却されます。
・SALES:実売上

処理失敗時は処理前のステータスが返却されます。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
OrderID=ORDER0000001&Status=SALES
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

PaidReturn 返品

決済が完了した取引に対して返品を行います。
※実売上後、180日以上経過すると返品できません。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

AccessID 必須 半角英数32桁 固定
取引ID

AccessPass 必須 半角英数32桁 固定
取引パスワード

OrderID 必須 半角英数記号27桁
オーダーID

URL
/payment/PaidReturn.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001
レスポンス
正常
OrderID 半角英数記号27桁
オーダーID

Status
現状態

処理成功時は以下のステータスが返却されます。
・RETURN:返品

処理失敗時は処理前のステータスが返却されます。

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
OrderID=ORDER0000001&Status=RETURN
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

SearchTradeMulti 取引状態参照

指定したオーダーIDの取引情報を取得します。

リクエスト
ShopID 必須 半角英数13桁
ショップID

ShopPass 必須 半角英数64桁
ショップパスワード

OrderID 必須 半角英数記号27桁
オーダーID

PayType 必須 半角数字2桁
決済方法

29:Paid

URL
/payment/SearchTradeMulti.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&PayType=29
レスポンス
正常
Status
現状態

UNPROCESSED:未決済
REQSUCCESS:要求成功
PAYFAIL:決済失敗
AUTH:仮売上
SALES:実売上
RETURN:返品
CANCEL:キャンセル

ProcessDate 半角数字14桁 固定
処理日時

yyyyMMddHHmmss形式

JobCd
処理区分

AUTH:仮売上
SALES:実売上
CHANGE:金額変更
RETURN:返品
CANCEL:キャンセル

AccessID 半角英数32桁 固定
取引ID

AccessPass 半角英数32桁 固定
取引パスワード

Amount 半角数字10桁
利用金額

Tax 半角数字10桁
税送料

ClientField1 全半角100バイト
加盟店自由項目1

ClientField2 全半角100バイト
加盟店自由項目2

ClientField3 全半角100バイト
加盟店自由項目3

PayType 半角数字2桁
決済方法

29:Paid決済

PaidCancelAmount 半角数字10桁
Paidキャンセル金額

PaidCancelTax 半角数字10桁
Paidキャンセル税送料

PaidBuyerID 半角英数記号20桁
Paid取引先ID

PaidCode 半角英数記号27桁
Paid伝票番号

Paid決済時に当サービスで発行する伝票番号です。
※オーダーIDを伝票番号として扱うため、オーダーIDと同一の値となります。

PaidContents 全半角160バイト
Paid注文内容

異常
ErrCode 半角英数3桁 固定
エラーコード
ErrInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
Status=AUTH&ProcessDate=20220801121212&JobCd=AUTH&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&Amount=100&Tax=0&ClientField1=加盟店自由項目1&ClientField2=加盟店自由項目2&ClientField3=加盟店自由項目3&PayType=29&ErrCode=&ErrInfo=&PaidCancelAmount=50&PaidCancelTax=0&PaidBuyerID=123456789&PaidCode=ORDER0000001&PaidContents=注文内容
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001